// 《围棋》作者版权所有。保留所有权利。
// 此源代码的使用受BSD样式
// 许可证的约束，该许可证可以在许可证文件中找到。

package types

import (
	"cmd/compile/internal/base"
	"cmd/internal/src"
)

// 声明堆栈和操作

var blockgen int32 = 1 // 最大块号
var Block int32 = 1    // 当前块号

// dsym存储符号的阴影声明，以便在块作用域结束后可以恢复。
type dsym struct {
	sym        *Sym // sym==nil表示堆栈标记
	def        Object
	block      int32
	lastlineno src.XPos // 诊断
}

// dclstack维护一个隐藏符号声明堆栈，以便
// Popdcl可以在块作用域结束时恢复其声明。
var dclstack []dsym

// Pushdcl推送符号s（如果有）的当前声明，以便
// 它可以被嵌套块范围内的新声明隐藏。
func Pushdcl(s *Sym) {
	dclstack = append(dclstack, dsym{
		sym:        s,
		def:        s.Def,
		block:      s.Block,
		lastlineno: s.Lastlineno,
	})
}

// Popdcl弹出最里面的块作用域，并将所有符号声明
// 恢复到其以前的状态。
func Popdcl() {
	for i := len(dclstack); i > 0; i-- {
		d := &dclstack[i-1]
		s := d.sym
		if s == nil {
			// 弹出堆栈标记
			Block = d.block
			dclstack = dclstack[:i-1]
			return
		}

		s.Def = d.def
		s.Block = d.block
		s.Lastlineno = d.lastlineno

		// 清除无效指针字段。
		d.sym = nil
		d.def = nil
	}
	base.Fatalf("popdcl: no stack mark")
}

// Markdcl记录声明的新块作用域的开始。
func Markdcl() {
	dclstack = append(dclstack, dsym{
		sym:   nil, // 堆栈标记
		block: Block,
	})
	blockgen++
	Block = blockgen
}

func isDclstackValid() bool {
	for _, d := range dclstack {
		if d.sym == nil {
			return false
		}
	}
	return true
}

// PkgDef返回与包作用域中的s关联的定义。
func (s *Sym) PkgDef() Object {
	return *s.pkgDefPtr()
}

// SetPkgDef在包范围内设置与s关联的定义。
func (s *Sym) SetPkgDef(n Object) {
	*s.pkgDefPtr() = n
}

func (s *Sym) pkgDefPtr() *Object {
	// 查找保存的最外层声明，该声明必须是
	// 包范围定义（如果存在）。
	for i := range dclstack {
		d := &dclstack[i]
		if s == d.sym {
			return &d.def
		}
	}

	// 否则，该声明未隐藏在
	// 函数范围内。
	return &s.Def
}

func CheckDclstack() {
	if !isDclstackValid() {
		base.Fatalf("mark left on the dclstack")
	}
}
